Developer Documentation

QuickTime 4 API Documentation

Programming With QuickTime VR

| Previous | Chapter Contents | Chapter Top | Next |

Imaging Property Types

The imagingProperty parameter of the functions QTVRGetImagingProperty and QTVRSetImagingProperty specifies the type of imaging property of a panoramic node whose value you want to get or set. These constants define the available imaging properties:

enum {
    kQTVRImagingCorrection                          = 1,
    kQTVRImagingQuality                             = 2,
    kQTVRImagingDirectDraw                          = 3,
    kQTVRImagingCurrentMode                         = 100
};
#define kQTVRImagingDefaultValue                    0x80000000

Constant descriptions

kQTVRImagingCorrection
The correction mode property. This property determines the type of image correction to be applied when imaging a panoramic view. The acceptable values for this property type are described in "Correction Modes" .
kQTVRImagingQuality
The imaging quality property. This property determines the quality of the output image. The acceptable values for this property type are described in "Quality Properties" .
kQTVRImagingDirectDraw
The direct-drawing property. This property determines the immediate destination of an image. The value of this property (as specified by the propertyValue parameter) is interpreted as a Boolean value. If the value is true , then images are computed and drawn directly to the final destination without first being drawn in the prescreen buffer maintained by QuickTime VR. This value provides the fastest overall frame rate but may result in relatively slower individual frame drawing for high-quality, high-resolution images on lower performance systems. If the value of this property is false , then images are computed and drawn first into the prescreen buffer and then to the final destination. This value provides the shortest imaging time for each individual frame but results in a reduced overall frame rate.
kQTVRImagingCurrentMode
The current imaging mode property. When you pass this property selector to the QTVRGetImagingProperty function, it returns, in the propertyValue parameter, the current imaging mode (that is, either kQTVRStatic or kQTVRMotion ). If the kQTVRImagingDefaultValue bit is set, the default imaging mode is returned. You can get but not set the value of this property. You might want to determine the current imaging mode in an imaging callback procedure if what you draw depends on the current imaging mode.
kQTVRImagingDefaultValue
The default value specifier. You can OR this value with any of the imaging property types to get or set the default value of that property type.

The kQTVRImagingDirectDraw property cannot always be supported. During updates, QuickTime VR's warping engine might ignore a value of true and draw the image first into the prescreen buffer and then into the final destination.


© 1998 Apple Computer, Inc.

| Previous | Chapter Contents | Chapter Top | Next |